home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / strip.z / strip
Text File  |  1998-10-30  |  8KB  |  199 lines
  1.  
  2.  
  3.  
  4. SSSSTTTTRRRRIIIIPPPP((((1111))))                                                              SSSSTTTTRRRRIIIIPPPP((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      strip - remove symbols and relocation bits
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ssssttttrrrriiiipppp [ ----bbbb ----ffff ----hhhh ----uuuu ----llll ----oooo_o_u_t_f_i_l_e ----rrrr ----ssss ----SSSS ----VVVV ----xxxx ] name ...
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The _s_t_r_i_p command removes the symbol table (the section named ".symtab",
  16.      Elf section kind SHT_SYMTAB) and relocation bits ordinarily attached to
  17.      the output of the assembler and loader.  This is useful to save space
  18.      after a program has been debugged.
  19.  
  20.      Unless option -_f is given, only objects marked with ELF type ET_EXEC (the
  21.      type given to main programs) are stripped.  See /_u_s_r/_i_n_c_l_u_d_e/_e_l_f._h for
  22.      the type codes.
  23.  
  24.      The effect of the default _s_t_r_i_p is similar to use of the ----ssss option of _l_d.
  25.  
  26.      _S_t_r_i_p recognizes the following options:
  27.  
  28.           ----bbbb   Same effect as the default behavior.  This option, though
  29.                accepted, is obsolete.
  30.  
  31.           ----ffff   Allows stripping information from any ELF file (including
  32.                relocatable object files and Dynamic Shared Objects) and any
  33.                ELF file inside an archive.
  34.  
  35.           ----hhhh   Removes symbol names from SHT_DYNSYM and/or SHT_SYMTAB section
  36.                symbol entries marked STO_HIDDEN or STO_INTERNAL.  Makes
  37.                strings in certain string tables into all zeros.  (Symbols may
  38.                be marked STO_HIDDEN or STO_INTERNAL by the _l_d(1) options
  39.                -_h_i_d_d_e_n__s_y_m_b_o_l or -_h_i_d_e_s__f_i_l_e.)  This option saves no space in
  40.                the object, so there is no point to using it on most ELF files.
  41.  
  42.           ----llll   Strips line number information only from -n32 or -64 object
  43.                files.  Doesn't strip the ELF symbol table or debugging
  44.                information other than the line number information.  Does
  45.                nothing on -32 object files.
  46.  
  47.           ----oooo _o_u_t_f_i_l_e
  48.                Specifies a name for the output file.  It is a mistake to
  49.                specify more than one _n_a_m_e to strip, since only one stripped
  50.                outputfile is created if ----oooo _o_u_t_f_i_l_e is specified.  The output
  51.                file is created with mode 0644.
  52.  
  53.           ----uuuu   When combined with -o, the new output file has the current user
  54.                ID and group ID.  By default (without -u) -o applies the user
  55.                ID and group ID of the input file to the output file.  Ignored
  56.                if -o not supplied.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSTTTTRRRRIIIIPPPP((((1111))))                                                              SSSSTTTTRRRRIIIIPPPP((((1111))))
  71.  
  72.  
  73.  
  74.           ----rrrr   Same effect as the default behavior.  This option, though
  75.                accepted, is obsolete.
  76.  
  77.           ----ssss   Strips some sections beyond the default strippable set.
  78.                _p_i_x_i_e,_c_o_r_d, and some other object tools cannot be used on a dso
  79.                or a.out with these additional sections stripped.  This is
  80.                intended for standalone programs (for which the space savings
  81.                is more important than the ability to use object tools on the
  82.                resulting file).
  83.  
  84.           ----kkkk   When used with ----ssss this adds the .debug_frame section to the
  85.                list of sections stripped. This option is not relevant for
  86.                old-32bit ABI objects.  When used without ----ssss the ----kkkk option does
  87.                nothing at all.  If the .debug_frame section (which only
  88.                appears in n32 and 64 ABI objects) is stripped from an
  89.                executable or DSO or object then C++ exception handling may
  90.                silently work incorrectly.  It is extremely unwise to use ----kkkk on
  91.                any DSO (though if the DSO is never in use with C++ exceptions
  92.                there is no harm in removing .debug_frame, how can one be sure
  93.                that the DSO won't be used with C++ exceptions?).  Use ----kkkk on an
  94.                executable only if a) space saving on disk is of paramount
  95.                importance and b) you know that no C++ exceptions can occur in
  96.                the application (and preferably none can occur in any DSO it
  97.                calls (directly or indirectly)).
  98.  
  99.           ----SSSS   Suppress all messages (run silently).
  100.  
  101.           ----VVVV   Prints, on _s_t_d_e_r_r, the version number of _s_t_r_i_p.
  102.  
  103.           ----xxxx   Turns off stripping the ELF ".symtab" (SHT_SYMTAB) symbol table
  104.                section from the object.
  105.  
  106. FFFFIIIILLLLEEEESSSS
  107.      strp1_x_x_x_x_x
  108.      strp2_x_x_x_x_x
  109.      /usr/tmp/strp1_x_x_x_x_x
  110.      /usr/tmp/strp2_x_x_x_x_x
  111.      where xxxxx is a suffix created by _t_e_m_p_n_a_m(_3_S).
  112.  
  113. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  114.      ld(1), pixie(1), tempnam(3S), cord(1)
  115.  
  116. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  117.      _s_t_r_i_p returns 0 to the environment if there are no errors.  In case of
  118.      any error, a non-zero value is returned to the environment with _e_x_i_t (_3).
  119.  
  120. NNNNOOOOTTTTEEEESSSS
  121.      The ----bbbb and ----rrrr options have no effect other than printing a warning.
  122.      These options will be removed in a future release.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. SSSSTTTTRRRRIIIIPPPP((((1111))))                                                              SSSSTTTTRRRRIIIIPPPP((((1111))))
  137.  
  138.  
  139.  
  140.      Temporary files are created during execution. Up to three times the space
  141.      of each original file being stripped may be needed while the program is
  142.      in operation.  Temporary files may be created in /_u_s_r/_t_m_p and in the
  143.      directory given on the command line (if no directory is specified in the
  144.      file pathname the current directory is assumed).  If the command is strip
  145.      /a/b/c then the directory /_a/_b must have permissions to allow file
  146.      creation, writing, and reading.  Whether /_a/_b/_c is a file (with or
  147.      without multiple links) or a symbolic link to a file, the directory /_a/_b
  148.      must allow file creation, writing, and reading.  If /_a/_b/_c is a symbolic
  149.      link then the true directory of the real file (which could be on a
  150.      different machine or filesystem than /_a/_b) must also allow file creation,
  151.      writing, and reading.
  152.  
  153.      The ----ssss option removes the line-table section removed by the ----llll option so
  154.      using  both is just like using the ----ssss option without using the ----llll option.
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.